WAIT EVENT TO

Description:
This command waits for a mouse click in any of the currently active GET
regions and returns the event label into the specified memory variable.
NOFLASH is an optional command that suppresses the flashing or redrawing
of the button that was clicked.  See the Technical Reference section for
more details about the event region GET list array.

Syntax:
WAIT EVENT TO <memvar>

Arguments:
<memvar> is a memory variable to store the region clicked by the mouse.
[NOFLASH] is an optional command that suppresses the redrawing of the
  button object.

Example:
DEFINE EVENT "1" AT 03,08 USING SUPER ICON 2 SHADOW ACTIVATE
DEFINE EVENT "2" AT 09,08 USING SUPER ICON 4 SHADOW ACTIVATE
DEFINE EVENT "3" AT 15,08 USING SUPER ICON 6 SHADOW ACTIVATE
DEFINE EVENT "4" AT 21,08 USING SUPER ICON 7 SHADOW ACTIVATE
DEFINE EVENT "5" AT 21,70 USING SUPER ICON 1 SHADOW ACTIVATE
WAIT EVENT TO CHOICE_                     // wait for a mouse press

         Purpose: Wait for a mouse click, return the event label
 Mapped Function: __WaitForEvent() contained in GLLIBR.PRG.
   dGE functions: mstatus(),mgethot()
   Other GL UDFs: __FindObject(),__FlaEventRegion()
System variables: _handles_[]
System constants: None.

See Also:
DEFINE EVENT, ACTIVATE EVENT, DEACTIVATE EVENT, RELEASE EVENT